Audience
Create multiple audiences
Creates multiple audiences in a single operation.
Limited to 1000 audiences per request.
POST
/
audiences
/
bulk-add
Create multiple audiences
curl --request POST \
--url https://your_a2_service/audiences/bulk-add \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"id": "<string>",
"alt_id": {},
"created_at": "2023-11-07T05:31:56Z",
"id_type": "account_id",
"properties": {},
"updated_at": "2023-11-07T05:31:56Z"
}
]
'import requests
url = "https://your_a2_service/audiences/bulk-add"
payload = [
{
"id": "<string>",
"alt_id": {},
"created_at": "2023-11-07T05:31:56Z",
"id_type": "account_id",
"properties": {},
"updated_at": "2023-11-07T05:31:56Z"
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
id: '<string>',
alt_id: {},
created_at: '2023-11-07T05:31:56Z',
id_type: 'account_id',
properties: {},
updated_at: '2023-11-07T05:31:56Z'
}
])
};
fetch('https://your_a2_service/audiences/bulk-add', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your_a2_service/audiences/bulk-add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'id' => '<string>',
'alt_id' => [
],
'created_at' => '2023-11-07T05:31:56Z',
'id_type' => 'account_id',
'properties' => [
],
'updated_at' => '2023-11-07T05:31:56Z'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your_a2_service/audiences/bulk-add"
payload := strings.NewReader("[\n {\n \"id\": \"<string>\",\n \"alt_id\": {},\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"id_type\": \"account_id\",\n \"properties\": {},\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your_a2_service/audiences/bulk-add")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"id\": \"<string>\",\n \"alt_id\": {},\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"id_type\": \"account_id\",\n \"properties\": {},\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://your_a2_service/audiences/bulk-add")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"id\": \"<string>\",\n \"alt_id\": {},\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"id_type\": \"account_id\",\n \"properties\": {},\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n]"
response = http.request(request)
puts response.read_body{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
application/json
Alternate identifier for the audience
The date and time the entity was created.
The type of the identifier
Properties for the audience
The key is AudienceAttribute.code, and the value can be a list of AudienceAttributeValue.value
Show child attributes
Show child attributes
The date and time the entity was last updated.
Response
Successful Response
Was this page helpful?
⌘I
Create multiple audiences
curl --request POST \
--url https://your_a2_service/audiences/bulk-add \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"id": "<string>",
"alt_id": {},
"created_at": "2023-11-07T05:31:56Z",
"id_type": "account_id",
"properties": {},
"updated_at": "2023-11-07T05:31:56Z"
}
]
'import requests
url = "https://your_a2_service/audiences/bulk-add"
payload = [
{
"id": "<string>",
"alt_id": {},
"created_at": "2023-11-07T05:31:56Z",
"id_type": "account_id",
"properties": {},
"updated_at": "2023-11-07T05:31:56Z"
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
id: '<string>',
alt_id: {},
created_at: '2023-11-07T05:31:56Z',
id_type: 'account_id',
properties: {},
updated_at: '2023-11-07T05:31:56Z'
}
])
};
fetch('https://your_a2_service/audiences/bulk-add', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://your_a2_service/audiences/bulk-add",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'id' => '<string>',
'alt_id' => [
],
'created_at' => '2023-11-07T05:31:56Z',
'id_type' => 'account_id',
'properties' => [
],
'updated_at' => '2023-11-07T05:31:56Z'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://your_a2_service/audiences/bulk-add"
payload := strings.NewReader("[\n {\n \"id\": \"<string>\",\n \"alt_id\": {},\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"id_type\": \"account_id\",\n \"properties\": {},\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://your_a2_service/audiences/bulk-add")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"id\": \"<string>\",\n \"alt_id\": {},\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"id_type\": \"account_id\",\n \"properties\": {},\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://your_a2_service/audiences/bulk-add")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"id\": \"<string>\",\n \"alt_id\": {},\n \"created_at\": \"2023-11-07T05:31:56Z\",\n \"id_type\": \"account_id\",\n \"properties\": {},\n \"updated_at\": \"2023-11-07T05:31:56Z\"\n }\n]"
response = http.request(request)
puts response.read_body{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}